home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #1 / Amiga Plus CD - 2000 - No. 1.iso / Tools / Dev / Meshwriter_lib / Library / autodoc / meshwriter.doc
Encoding:
Text File  |  1999-12-03  |  56.5 KB  |  2,112 lines
  1. TABLE OF CONTENTS
  2.  
  3. meshwriter.library/MWL2DFileFormatExtensionGet
  4. meshwriter.library/MWL2DFileFormatIDGet
  5. meshwriter.library/MWL2DFileFormatNamesGet
  6. meshwriter.library/MWL2DFileFormatNumberOfGet
  7. meshwriter.library/MWL3DFileFormatExtensionGet
  8. meshwriter.library/MWL3DFileFormatIDGet
  9. meshwriter.library/MWL3DFileFormatNamesGet
  10. meshwriter.library/MWL3DFileFormatNumberOfGet
  11. meshwriter.library/MWLDrawModeIDGet
  12. meshwriter.library/MWLDrawModeNamesGet
  13. meshwriter.library/MWLDrawModeNumberOfGet
  14. meshwriter.library/MWLMeshCameraLightDefaultSet
  15. meshwriter.library/MWLMeshCameraLookAtGet
  16. meshwriter.library/MWLMeshCameraLookAtSet
  17. meshwriter.library/MWLMeshCameraPositionGet
  18. meshwriter.library/MWLMeshCameraPositionSet
  19. meshwriter.library/MWLMeshCopyrightGet
  20. meshwriter.library/MWLMeshCopyrightSet
  21. meshwriter.library/MWLMeshCTMReset
  22. meshwriter.library/MWLMeshDelete
  23. meshwriter.library/MWLMeshLightColorGet
  24. meshwriter.library/MWLMeshLightColorSet
  25. meshwriter.library/MWLMeshLightPositionGet
  26. meshwriter.library/MWLMeshLightPositionSet
  27. meshwriter.library/MWLMeshMaterialAdd
  28. meshwriter.library/MWLMeshMaterialAmbientColorGet
  29. meshwriter.library/MWLMeshMaterialAmbientColorSet
  30. meshwriter.library/MWLMeshMaterialDiffuseColorGet
  31. meshwriter.library/MWLMeshMaterialDiffuseColorSet
  32. meshwriter.library/MWLMeshMaterialNameGet
  33. meshwriter.library/MWLMeshMaterialNameSet
  34. meshwriter.library/MWLMeshMaterialShininessGet
  35. meshwriter.library/MWLMeshMaterialShininessSet
  36. meshwriter.library/MWLMeshMaterialTransparencyGet
  37. meshwriter.library/MWLMeshMaterialTransparencySet
  38. meshwriter.library/MWLMeshNameGet
  39. meshwriter.library/MWLMeshNameSet
  40. meshwriter.library/MWLMeshNew
  41. meshwriter.library/MWLMeshNumberOfMaterialsGet
  42. meshwriter.library/MWLMeshNumberOfPolygonsGet
  43. meshwriter.library/MWLMeshNumberOfVerticesGet
  44. meshwriter.library/MWLMeshPolygonAdd
  45. meshwriter.library/MWLMeshPolygonMaterialSet
  46. meshwriter.library/MWLMeshPolygonVertexAdd
  47. meshwriter.library/MWLMeshPolygonVertexAssign
  48. meshwriter.library/MWLMeshRotationChange
  49. meshwriter.library/MWLMeshRotationGet
  50. meshwriter.library/MWLMeshSave2D
  51. meshwriter.library/MWLMeshSave3D
  52. meshwriter.library/MWLMeshScaleChange
  53. meshwriter.library/MWLMeshScaleGet
  54. meshwriter.library/MWLMeshTranslationChange
  55. meshwriter.library/MWLMeshTranslationGet
  56. meshwriter.library/MWLMeshTriangleAdd
  57. meshwriter.library/MWLMeshVertexAdd
  58. meshwriter.library/MWL2DFileFormatExtensionGet                 meshwriter.library/MWL2DFileFormatExtensionGet
  59.  
  60.    NAME    
  61.      MWL2DFileFormatExtensionGet -- Get the file extension of a specific 2D file format.
  62.  
  63.    SYNOPSIS
  64.     ext = MWL2DFileFormatExtensionGet( ffid )
  65.                                        D1
  66.  
  67.     STRPTR MWL2DFileFormatExtensionGet
  68.          ( ULONG );
  69.  
  70.    FUNCTION
  71.     You will get a pointer to the extension of the specified 2D file format.
  72.     This strings are READ_ONLY and only valid as long as the library is opened.
  73.  
  74.    INPUTS
  75.     ffid - ID of the format you search the extension for.
  76.     
  77.    RESULT
  78.      ext - Pointer to the file extension string or NULL if the format is unknown.
  79.  
  80.    EXAMPLE
  81.     ext = MWL2DFileFormatExtensionGet(id);
  82.  
  83.    NOTES
  84.     This extensions are proposals of the format creators, but you are free
  85.     to use them.
  86.  
  87.    BUGS
  88.  
  89.    SEE ALSO
  90.      MWL2DFileFormatNamesGet(),MWL2DFileFormatIDGet()
  91.     MWL2DFileFormatNumberOfGet()
  92.  
  93. meshwriter.library/MWL2DFileFormatIDGet                               meshwriter.library/MWL2DFileFormatIDGet
  94.  
  95.    NAME    
  96.      MWL2DFileFormatIDGet -- Get the ID of a specific 2D file format.
  97.  
  98.    SYNOPSIS
  99.     id = MWL2DFileFormatIDGet( ffname )
  100.                                D1
  101.  
  102.     ULONG MWL2DFileFormatIDGet
  103.          ( STRPTR );
  104.  
  105.    FUNCTION
  106.     You will get the ID of the 2D file format of which you passed its name.
  107.  
  108.    INPUTS
  109.     ffname - Name of the format you search the ID for.
  110.     
  111.    RESULT
  112.      id - The ID of the 2D file format or 0 if not found/supported.
  113.  
  114.    EXAMPLE
  115.     id = MWL2DFileFormatIDGet("PostScript");
  116.  
  117.    NOTES
  118.     Even if the values of the IDs wont change in future versions, it is
  119.     recomended to show the list of all names to the user and let him choose
  120.     the format. With the help of this function you will get the correct
  121.     ID which is needed for further function calls.
  122.  
  123.    BUGS
  124.  
  125.    SEE ALSO
  126.      MWL2DFileFormatNamesGet(),MWL2DFileFormatExtensionGet()
  127.     MWL2DFileFormatNumberOfGet()
  128.  
  129. meshwriter.library/MWL2DFileFormatNamesGet                         meshwriter.library/MWL2DFileFormatNamesGet
  130.  
  131.    NAME    
  132.      MWL2DFileFormatNamesGet -- Get a name list of all supported 2D file formats.
  133.  
  134.    SYNOPSIS
  135.     list = MWL2DFileFormatNamesGet(  )
  136.  
  137.     STRPTR * MWL2DFileFormatNamesGet
  138.          (  );
  139.  
  140.    FUNCTION
  141.     You will get a pointer to the namelist of all supported 2D file formats.
  142.     This strings are READ_ONLY and only valid as long as the library is opened.
  143.  
  144.     The list is sorted alphabetically.
  145.  
  146.     The resulting pointer can directly be used to fill up cycle or list gadgets
  147.     for example.
  148.  
  149.    INPUTS
  150.     
  151.    RESULT
  152.      list - A NULL terminated array of string pointers. Or NULL if no
  153.            files are supported.
  154.  
  155.    EXAMPLE
  156.     list = MWL2DFileFormatNamesGet();
  157.  
  158.    NOTES
  159.  
  160.    BUGS
  161.  
  162.    SEE ALSO
  163.      MWL2DFileFormatIDGet(),MWL2DFileFormatExtensionGet()
  164.     MWL2DFileFormatNumberOfGet()
  165.  
  166. meshwriter.library/MWL2DFileFormatNumberOfGet                   meshwriter.library/MWL2DFileFormatNumberOfGet
  167.  
  168.    NAME    
  169.      MWL2DFileFormatNumberOfGet -- Get the number of supported 2D file formats.
  170.  
  171.    SYNOPSIS
  172.     number = MWL2DFileFormatNumberOfGet( )
  173.  
  174.     ULONG MWL2DFileFormatNumberOfGet
  175.          ( );
  176.  
  177.    FUNCTION
  178.     You will get the number of supported 2D file formats of this library version.
  179.  
  180.    INPUTS
  181.     
  182.    RESULT
  183.      number - Number of supported file formats or 0 if none.
  184.  
  185.    EXAMPLE
  186.     number = MWL2DFileFormatNumberOfGet();
  187.  
  188.    NOTES
  189.  
  190.    BUGS
  191.  
  192.    SEE ALSO
  193.      MWL2DFileFormatNamesGet(),MWL2DFileFormatIDGet()
  194.     MWL2DFileFormatNumberExtensionGet()
  195.  
  196. meshwriter.library/MWL3DFileFormatExtensionGet                 meshwriter.library/MWL3DFileFormatExtensionGet
  197.  
  198.    NAME    
  199.      MWL3DFileFormatExtensionGet -- Get the file extension of a specific 3D file format.
  200.  
  201.    SYNOPSIS
  202.     ext = MWL3DFileFormatExtensionGet( ffid )
  203.                                        D1
  204.  
  205.     STRPTR MWL3DFileFormatExtensionGet
  206.          ( ULONG );
  207.  
  208.    FUNCTION
  209.     You will get a pointer to the extension of the specified 3D file format.
  210.     This strings are READ_ONLY and only valid as long as the library is opened.
  211.  
  212.    INPUTS
  213.     ffid - ID of the file format you search the extension for.
  214.     
  215.    RESULT
  216.      ext - Pointer to the file extension string or NULL if the format is unknown.
  217.  
  218.    EXAMPLE
  219.     ext = MWL3DFileFormatExtensionGet(id);
  220.  
  221.    NOTES
  222.     This extensions are proposals of the format creators, but you are free
  223.     to use them.
  224.  
  225.    BUGS
  226.  
  227.    SEE ALSO
  228.      MWL3DFileFormatNamesGet(),MWL3DFileFormatIDGet()
  229.     MWL3DFileFormatNumberOfGet()
  230.  
  231. meshwriter.library/MWL3DFileFormatIDGet                               meshwriter.library/MWL3DFileFormatIDGet
  232.  
  233.    NAME    
  234.      MWL3DFileFormatIDGet -- Get the ID of a specific 3D file format.
  235.  
  236.    SYNOPSIS
  237.     id = MWL3DFileFormatIDGet( ffname )
  238.                                 D1
  239.  
  240.     ULONG MWL3DFileFormatIDGet
  241.          ( STRPTR );
  242.  
  243.    FUNCTION
  244.     You will get the ID of the 3D file format of which you passed its name.
  245.  
  246.    INPUTS
  247.     ffname - Name of the format you search the ID for.
  248.     
  249.    RESULT
  250.      id - The ID of the 3D file format or 0 if not found/supported.
  251.  
  252.    EXAMPLE
  253.     id = MWL3DFileFormatIDGet("Lightwave");
  254.  
  255.    NOTES
  256.     Even if the values of the IDs wont change in future versions, it is
  257.     recomended to show the list of all names to the user and let him choose
  258.     the format. With the help of this function you will get the correct
  259.     ID which is needed for further function calls.
  260.  
  261.    BUGS
  262.  
  263.    SEE ALSO
  264.      MWL3DFileFormatNamesGet(),MWL3DFileFormatExtensionGet()
  265.     MWL3DFileFormatNumberOfGet()
  266.  
  267. meshwriter.library/MWL3DFileFormatNamesGet                         meshwriter.library/MWL3DFileFormatNamesGet
  268.  
  269.    NAME    
  270.      MWL3DFileFormatNamesGet -- Get a name list of all supported 3D file formats.
  271.  
  272.    SYNOPSIS
  273.     list = MWL3DFileFormatNamesGet(  )
  274.  
  275.     STRPTR * MWL3DFileFormatNamesGet
  276.          (  );
  277.  
  278.    FUNCTION
  279.     You will get a pointer to the namelist of all supported 3D file formats.
  280.     This strings are READ_ONLY and only valid as long as the library is opened.
  281.  
  282.     The list is sorted alphabetically.
  283.  
  284.     The resulting pointer can directly be used to fill up cycle or list gadgets
  285.     for example.
  286.  
  287.    INPUTS
  288.     
  289.    RESULT
  290.      list - A NULL terminated array of string pointers. Or NULL if no
  291.            files are supported.
  292.  
  293.    EXAMPLE
  294.     list = MWL3DFileFormatNamesGet();
  295.  
  296.    NOTES
  297.  
  298.    BUGS
  299.  
  300.    SEE ALSO
  301.      MWL3DFileFormatIDGet(),MWL3DFileFormatExtensionGet()
  302.     MWL3DFileFormatNumberOfGet()
  303.  
  304. meshwriter.library/MWL3DFileFormatNumberOfGet                   meshwriter.library/MWL3DFileFormatNumberOfGet
  305.  
  306.    NAME    
  307.      MWL3DFileFormatNumberOfGet -- Get the number of supported 3D file formats.
  308.  
  309.    SYNOPSIS
  310.     number = MWL3DFileFormatNumberOfGet( )
  311.  
  312.     ULONG MWL3DFileFormatNumberOfGet
  313.          ( );
  314.  
  315.    FUNCTION
  316.     You will get the number of supported 3D file formats of this library version.
  317.  
  318.    INPUTS
  319.     
  320.    RESULT
  321.      number - Number of supported file formats or 0 if none.
  322.  
  323.    EXAMPLE
  324.     number = MWL3DFileFormatNumberOfGet();
  325.  
  326.    NOTES
  327.  
  328.    BUGS
  329.  
  330.    SEE ALSO
  331.      MWL3DFileFormatNamesGet(),MWL3DFileFormatIDGet()
  332.     MWL3DFileFormatNumberExtensionGet()
  333.  
  334. meshwriter.library/MWLDrawModeIDGet                                       meshwriter.library/MWLDrawModeIDGet
  335.  
  336.    NAME 
  337.         MWLDrawModeIDGet -- Get the ID of a specific drawing mode.
  338.  
  339.    SYNOPSIS
  340.         id = MWLDrawModeIDGet( dmname )
  341.                                D1
  342.  
  343.         ULONG MWLDrawModeIDGet
  344.              ( STRPTR );
  345.  
  346.    FUNCTION
  347.         You will get the ID of the drawing mode of which you passed its name.
  348.  
  349.    INPUTS
  350.         dm - Name of the drawing mode you search the ID for.
  351.         
  352.    RESULT
  353.         id - The ID of the drawing mode or 0 if not found/supported.
  354.  
  355.    EXAMPLE
  356.         id = MWLDrawModeIDGet("Points");
  357.  
  358.    NOTES
  359.         Even if the values of the IDs wont change in future versions, it is
  360.         recomended to show the list of all names to the user and let him choose
  361.         the format. With the help of this function you will get the correct
  362.         ID which is needed for further function calls.
  363.  
  364.    BUGS
  365.  
  366.    SEE ALSO
  367.         MWLDrawModeNamesGet(),MWLDrawModeNumberOfGet()
  368.  
  369. meshwriter.library/MWLDrawModeNamesGet                                 meshwriter.library/MWLDrawModeNamesGet
  370.  
  371.    NAME 
  372.         MWLDrawModeNamesGet -- Get a name list of all supported drawing modes.
  373.  
  374.    SYNOPSIS
  375.         list = MWLDrawModeNamesGet(  )
  376.  
  377.         STRPTR * MWLDrawModeNamesGet
  378.              (  );
  379.  
  380.    FUNCTION
  381.         You will get a pointer to the namelist of all supported drawing modes.
  382.         This strings are READ_ONLY and only valid as long as the library is opened.
  383.  
  384.         The resulting pointer can directly be used to fill up cycle or list gadgets
  385.         for example.
  386.  
  387.    INPUTS
  388.         
  389.    RESULT
  390.         list - A NULL terminated array of string pointers. Or NULL if no
  391.                modes are supported.
  392.  
  393.    EXAMPLE
  394.         list = MWLDrawModeNamesGet();
  395.  
  396.    NOTES
  397.  
  398.    BUGS
  399.  
  400.    SEE ALSO
  401.         MWLDrawModeIDGet(),MWLDrawModeNumberOfGet()
  402.  
  403. meshwriter.library/MWLDrawModeNumberOfGet                           meshwriter.library/MWLDrawModeNumberOfGet
  404.  
  405.    NAME 
  406.         MWLDrawModeNumberOfGet -- Get the number of supported drawing modes.
  407.  
  408.    SYNOPSIS
  409.         number = MWLDrawModeNumberOfGet( )
  410.  
  411.         ULONG MWLDrawModeNumberOfGet
  412.              ( );
  413.  
  414.    FUNCTION
  415.         You will get the number of supported drawing modes of this library version.
  416.  
  417.    INPUTS
  418.         
  419.    RESULT
  420.         number - Number of supported drawing modes or 0 if none.
  421.  
  422.    EXAMPLE
  423.         number = MWLDrawModeNumberOfGet();
  424.  
  425.    NOTES
  426.  
  427.    BUGS
  428.  
  429.    SEE ALSO
  430.         MWLDrawModeNamesGet(),MWLDrawModeIDGet()
  431.  
  432. meshwriter.library/MWLMeshCameraLightDefaultSet               meshwriter.library/MWLMeshCameraLightDefaultSet
  433.  
  434.    NAME    
  435.      MWLMeshCameraLightDefaultSet -- Set the camera and light to defaults.
  436.  
  437.    SYNOPSIS
  438.     error = MWLMeshCameraLightDefaultSet( meshhandle )
  439.                                           D1
  440.  
  441.     ULONG MWLMeshCameraLightDefaultSet
  442.          ( ULONG )
  443.  
  444.    FUNCTION
  445.     This function sets the camera and light properties as follows :
  446.     Camera looks to the center of the mesh and is positioned to view the whole mesh.
  447.     Light is positioned at the same point than the camera and gets a white color.
  448.  
  449.    INPUTS
  450.      meshhandle      - A valid handle of a mesh.
  451.     
  452.    RESULT
  453.      error - RCNOERROR    if all went well.
  454.             RCNOMESH     if the handle is not valid.
  455.  
  456.    EXAMPLE
  457.     error= MWLMeshCameraLightDefaultSet(meshhandle);
  458.  
  459.    NOTES
  460.     Camera and light will be used by some file formats only,
  461.     and for 2D or display functions.
  462.  
  463.     If no values are set, this function will be called internally before
  464.     using functions which need a camera or a light source.
  465.  
  466.    BUGS
  467.  
  468.    SEE ALSO
  469.      MWLMeshCameraPositionSet(),MWLMeshCameraLookAtSet(),
  470.     MWLMeshLightPositionSet(),MWLMeshLightColorSet()
  471.  
  472. meshwriter.library/MWLMeshCameraLookAtGet                           meshwriter.library/MWLMeshCameraLookAtGet
  473.  
  474.    NAME    
  475.      MWLMeshCameraLookAtGet -- Get the view point of the camera.
  476.  
  477.    SYNOPSIS
  478.     error = MWLMeshCameraLookAtGet( meshhandle,lookat )
  479.                                     D1          A0
  480.  
  481.     ULONG MWLMeshCameraLookAtGet
  482.          ( ULONG,TOCLVertex * );
  483.  
  484.    FUNCTION
  485.     The view point of the camera will be written in the passed vertex structure.
  486.  
  487.    INPUTS
  488.      meshhandle      - A valid handle of a mesh.
  489.     lookat          - Pointer to a vertex structure which will contain
  490.                       the position information.
  491.     
  492.    RESULT
  493.      error - RCNOERROR    if all went well.
  494.             RCNOMESH     if the handle is not valid.
  495.  
  496.    EXAMPLE
  497.     error = MWLMeshCameraLookAtGet(meshhandle,&myvertex);
  498.  
  499.    NOTES
  500.     The camera will be used by some file formats only,
  501.     and for 2D or display functions.
  502.  
  503.    BUGS
  504.  
  505.    SEE ALSO
  506.      MWLMeshCameraLookAtSet(),MWLMeshCameraPositionSet()
  507.     MWLMeshCameraPositionGet()
  508.  
  509. meshwriter.library/MWLMeshCameraLookAtSet                           meshwriter.library/MWLMeshCameraLookAtSet
  510.  
  511.    NAME    
  512.      MWLMeshCameraLookAtSet -- Set the camera its view point.
  513.  
  514.    SYNOPSIS
  515.     error = MWLMeshCameraLookAtSet( meshhandle,lookat )
  516.                                     D1          A0
  517.  
  518.     ULONG MWLMeshCameraLookAtSet
  519.          ( ULONG,TOCLVertex * );
  520.  
  521.    FUNCTION
  522.     The view point of the camera will be set to the values passed by the
  523.     vertex structure.
  524.  
  525.    INPUTS
  526.      meshhandle      - A valid handle of a mesh.
  527.     lookat          - Pointer to a vertex structure containing the position information.
  528.     
  529.    RESULT
  530.      error - RCNOERROR    if all went well.
  531.             RCNOMESH     if the handle is not valid.
  532.  
  533.    EXAMPLE
  534.     error = MWLMeshCameraLookAtSet(meshhandle,&myvertex);
  535.  
  536.    NOTES
  537.     The camera will be used by some file formats only,
  538.     and for 2D or display functions.
  539.  
  540.    BUGS
  541.  
  542.    SEE ALSO
  543.      MWLMeshCameraLookAtGet(),MWLMeshCameraPositionSet()
  544.     MWLMeshCameraPositionSet()
  545.  
  546. meshwriter.library/MWLMeshCameraPositionGet                       meshwriter.library/MWLMeshCameraPositionGet
  547.  
  548.    NAME    
  549.      MWLMeshCameraPositionGet -- Get the position of the camera.
  550.  
  551.    SYNOPSIS
  552.     error = MWLMeshCameraPositionGet( meshhandle,position )
  553.                                       D1          A0
  554.  
  555.     ULONG MWLMeshCameraPositionGet
  556.          ( ULONG,TOCLVertex * );
  557.  
  558.    FUNCTION
  559.     The position of the camera will be written in the passed vertex structure.
  560.  
  561.    INPUTS
  562.      meshhandle      - A valid handle of a mesh.
  563.     position        - Pointer to a vertex structure which will contain
  564.                       the position information.
  565.     
  566.    RESULT
  567.      error - RCNOERROR    if all went well.
  568.             RCNOMESH     if the handle is not valid.
  569.  
  570.    EXAMPLE
  571.     error = MWLMeshCameraPositionGet(meshhandle,&myvertex);
  572.  
  573.    NOTES
  574.     The camera will be used by some file formats only,
  575.     and for 2D or display functions.
  576.  
  577.    BUGS
  578.  
  579.    SEE ALSO
  580.      MWLMeshCameraPositionSet(),MWLMeshCameraLookAtSet()
  581.     MWLMeshCameraLookAtGet()
  582.  
  583. meshwriter.library/MWLMeshCameraPositionSet                       meshwriter.library/MWLMeshCameraPositionSet
  584.  
  585.    NAME    
  586.      MWLMeshCameraPositionSet -- Set the camera position.
  587.  
  588.    SYNOPSIS
  589.     error = MWLMeshCameraPositionSet( meshhandle,position )
  590.                                       D1          A0
  591.  
  592.     ULONG MWLMeshCameraPositionSet
  593.          ( ULONG,TOCLVertex * );
  594.  
  595.    FUNCTION
  596.     The position of the camera will be set to the values passed by the
  597.     vertex structure.
  598.  
  599.    INPUTS
  600.      meshhandle      - A valid handle of a mesh.
  601.     position        - Pointer to a vertex structure containing the position information.
  602.     
  603.    RESULT
  604.      error - RCNOERROR    if all went well.
  605. `            RCNOMESH     if the handle is not valid.
  606.  
  607.    EXAMPLE
  608.     error = MWLMeshCameraPositionSet(meshhandle,&myvertex);
  609.  
  610.    NOTES
  611.     The camera will be used by some file formats only,
  612.     and for 2D or display functions.
  613.  
  614.    BUGS
  615.  
  616.    SEE ALSO
  617.      MWLMeshCameraPositionGet(),MWLMeshCameraLookAtSet(),
  618.     MWLMeshCameraLookAtGet()
  619.  
  620. meshwriter.library/MWLMeshCopyrightGet                                 meshwriter.library/MWLMeshCopyrightGet
  621.  
  622.    NAME    
  623.      MWLMeshCopyrightGet -- Get the copyright of a mesh.
  624.  
  625.    SYNOPSIS
  626.     error = MWLMeshCopyrightGet( meshhandle,copyright )
  627.                                  D1         D2
  628.  
  629.     ULONG MWLMeshCopyrightGet
  630.          ( ULONG,STRPTR * );
  631.  
  632.    FUNCTION
  633.     You will get a pointer to the copyright of the mesh. This string is READ_ONLY
  634.     and only valid as long as the mesh exists.
  635.  
  636.    INPUTS
  637.      meshhandle    - A valid handle of a mesh.
  638.     copyright     - Pointer to the copyright of the mesh.
  639.     
  640.    RESULT
  641.      error - RCNOERROR if all went well.
  642.             RCNOMESH  if the handle is not valid.
  643.  
  644.    EXAMPLE
  645.     error = MWLMeshCopyrightGet(meshhandle,&mystring);
  646.  
  647.    NOTES
  648.  
  649.    BUGS
  650.  
  651.    SEE ALSO
  652.      MWLMeshCopyrightSet()
  653.  
  654. meshwriter.library/MWLMeshCopyrightSet                                 meshwriter.library/MWLMeshCopyrightSet
  655.  
  656.    NAME    
  657.      MWLMeshCopyrightSet -- Set the copyright of the mesh.
  658.  
  659.    SYNOPSIS
  660.     error = MWLMeshCopyrightSet( meshhandle,copyright )
  661.                                  D1         D2
  662.  
  663.     ULONG MWLMeshCopyrightSet
  664.          ( ULONG,STRPTR );
  665.  
  666.    FUNCTION
  667.     A copy of the passed string will be made and assigned to the mesh its
  668.     copyright string.
  669.  
  670.    INPUTS
  671.      meshhandle      - A valid handle of a mesh.
  672.     copyright       - String which contains the copyright.
  673.     
  674.    RESULT
  675.      error - RCNOERROR  if all went well.
  676.             RCNOMESH   if the handle is not valid.
  677.              RCNOMEMORY if there is not enough memory.
  678.  
  679.    EXAMPLE
  680.     error = MWLMeshCopyrightSet(meshhandle,"This mesh was created with GreatShaper V2.0 for Beethoven");
  681.  
  682.    NOTES
  683.     This should be only a single line !
  684.  
  685.     This function can be called as often as you need, which will replace
  686.     the old value.
  687.  
  688.     Not all formats support copyrights, and the written length of the
  689.     string depends of the format too.
  690.  
  691.    BUGS
  692.  
  693.    SEE ALSO
  694.      MWLMeshCopyrightGet()
  695.  
  696. meshwriter.library/MWLMeshCTMReset                                         meshwriter.library/MWLMeshCTMReset
  697.  
  698.    NAME    
  699.      MWLMeshCTMReset -- Resets the current transformation matrix and the scale.
  700.  
  701.    SYNOPSIS
  702.     error = MWLMeshCTMReset( meshhandle )
  703.                              D1
  704.  
  705.     ULONG MWLMeshCTMReset
  706.          ( ULONG );
  707.  
  708.    FUNCTION
  709.     The translation, rotation and scale factors will be set to the default values.
  710.     Translation is 0, rotation is 0 and scale is 1, for all axis.
  711.  
  712.  
  713.    INPUTS
  714.      meshhandle   - A valid handle of a mesh.
  715.     
  716.    RESULT
  717.      error - RCNOERROR          if all went well.
  718.             RCNOMESH           if the handle is not valid.
  719.  
  720.    EXAMPLE
  721.     error = MWLMeshCTMReset(meshhandle);
  722.  
  723.    NOTES
  724.  
  725.    BUGS
  726.  
  727.    SEE ALSO
  728.      MWLMeshTranslationChange(), MWLMeshTranslationGet()
  729.     MWLMeshRotationChange(),MWLMeshRotationGet()
  730.     MWLMeshScaleChange(),MWLMeshScaleGet()
  731.  
  732. meshwriter.library/MWLMeshDelete                                             meshwriter.library/MWLMeshDelete
  733.  
  734.    NAME    
  735.      MWLMeshDelete -- Delete a mesh which was created whith MWLMeshNew() before.
  736.  
  737.    SYNOPSIS
  738.     error = MWLMeshDelete( meshhandle )
  739.                            D1
  740.  
  741.     ULONG MWLMeshDelete
  742.          ( ULONG );
  743.  
  744.    FUNCTION
  745.     Free the memory occupied by the mesh, and delete the mesh itself.
  746.  
  747.    INPUTS
  748.      meshhandle    - A valid handle of a mesh.
  749.     
  750.    RESULT
  751.      error - RCNOERROR if all went well.
  752.             RCNOMESH  if the handle is not valid.
  753.  
  754.    EXAMPLE
  755.  
  756.    NOTES
  757.     Can take some time.
  758.  
  759.    BUGS
  760.  
  761.    SEE ALSO
  762.      MWLMeshNew()
  763.  
  764. meshwriter.library/MWLMeshLightColorGet                               meshwriter.library/MWLMeshLightColorGet
  765.  
  766.    NAME    
  767.      MWLMeshLightColorGet -- Get the color of the light source.
  768.  
  769.    SYNOPSIS
  770.     error = MWLMeshLightColorGet( meshhandle,color )
  771.                                   D1          A0
  772.  
  773.     ULONG MWLMeshLightColorGet
  774.          ( ULONG,TOCLColor * );
  775.  
  776.    FUNCTION
  777.     The color of the light source will be written in the passed color structure.
  778.  
  779.    INPUTS
  780.      meshhandle      - A valid handle of a mesh.
  781.     color           - Pointer to a color structure which will contain
  782.                       the color information.
  783.     
  784.    RESULT
  785.      error - RCNOERROR    if all went well.
  786.             RCNOMESH     if the handle is not valid.
  787.  
  788.    EXAMPLE
  789.     error = MWLMeshLightColorGet(meshhandle,&mycolor);
  790.  
  791.    NOTES
  792.     The light will be used by some file formats only,
  793.     and for 2D or display functions.
  794.  
  795.    BUGS
  796.  
  797.    SEE ALSO
  798.      MWLMeshLightColorSet(),MWLMeshLightPositionSet()
  799.     MWLMeshLightPositionGet()
  800.  
  801. meshwriter.library/MWLMeshLightColorSet                               meshwriter.library/MWLMeshLightColorSet
  802.  
  803.    NAME    
  804.      MWLMeshLightColorSet -- Set the light source its color.
  805.  
  806.    SYNOPSIS
  807.     error = MWLMeshLightColorSet( meshhandle,color )
  808.                                   D1          A0
  809.  
  810.     ULONG MWLMeshLightColorSet
  811.          ( ULONG,TOCLColor * );
  812.  
  813.    FUNCTION
  814.     The color of the light source will be set to the values passed by the
  815.     color structure.
  816.  
  817.    INPUTS
  818.      meshhandle      - A valid handle of a mesh.
  819.     color           - Pointer to a color structure containing the color information.
  820.     
  821.    RESULT
  822.      error - RCNOERROR    if all went well.
  823.             RCNOMESH     if the handle is not valid.
  824.  
  825.    EXAMPLE
  826.     error = MWLMeshLightColorSet(meshhandle,&mycolor);
  827.  
  828.    NOTES
  829.     The light will be used by some file formats only,
  830.     and for 2D or display functions.
  831.  
  832.    BUGS
  833.  
  834.    SEE ALSO
  835.      MWLMeshLightColorGet(),MWLMeshLightPositionSet()
  836.     MWLMeshLightPositionGet()
  837.  
  838. meshwriter.library/MWLMeshLightPositionGet                         meshwriter.library/MWLMeshLightPositionGet
  839.  
  840.    NAME    
  841.      MWLMeshLightPositionGet -- Get the position of the light source.
  842.  
  843.    SYNOPSIS
  844.     error = MWLMeshLightPositionGet( meshhandle,position )
  845.                                      D1          A0
  846.  
  847.     ULONG MWLMeshLightPositionGet
  848.          ( ULONG,TOCLVertex * );
  849.  
  850.    FUNCTION
  851.     The position of the light source will be written in the passed vertex structure.
  852.  
  853.    INPUTS
  854.      meshhandle      - A valid handle of a mesh.
  855.     position        - Pointer to a vertex structure which will contain
  856.                       the position information.
  857.     
  858.    RESULT
  859.      error - RCNOERROR    if all went well.
  860.             RCNOMESH     if the handle is not valid.
  861.  
  862.    EXAMPLE
  863.     error = MWLMeshLightPositionGet(meshhandle,&myvertex);
  864.  
  865.    NOTES
  866.     The light will be used by some file formats only,
  867.     and for 2D or display functions.
  868.  
  869.    BUGS
  870.  
  871.    SEE ALSO
  872.      MWLMeshLightPositionSet(),MWLMeshLightColorSet()
  873.     MWLMeshLightColorGet()
  874.  
  875. meshwriter.library/MWLMeshLightPositionSet                         meshwriter.library/MWLMeshLightPositionSet
  876.  
  877.    NAME    
  878.      MWLMeshLightPositionSet -- Set the light source its position.
  879.  
  880.    SYNOPSIS
  881.     error = MWLMeshLightPositionSet( meshhandle,position )
  882.                                      D1          A0
  883.  
  884.     ULONG MWLMeshLightPositionSet
  885.          ( ULONG,TOCLVertex * );
  886.  
  887.    FUNCTION
  888.     The position of the light source will be set to the values passed by the
  889.     vertex structure.
  890.  
  891.    INPUTS
  892.      meshhandle      - A valid handle of a mesh.
  893.     position        - Pointer to a vertex structure containing the position information.
  894.     
  895.    RESULT
  896.      error - RCNOERROR    if all went well.
  897.             RCNOMESH     if the handle is not valid.
  898.  
  899.    EXAMPLE
  900.     error = MWLMeshLightPositionSet(meshhandle,&myvertex);
  901.  
  902.    NOTES
  903.     The light will be used by some file formats only,
  904.     and for 2D or display functions.
  905.  
  906.    BUGS
  907.  
  908.    SEE ALSO
  909.      MWLMeshLightPositionGet(),MWLMeshLightColorSet()
  910.     MWLMeshLightColorGet()
  911.  
  912. meshwriter.library/MWLMeshMaterialAdd                                   meshwriter.library/MWLMeshMaterialAdd
  913.  
  914.    NAME    
  915.      MWLMeshMaterialAdd -- Add a new material to the mesh.
  916.  
  917.    SYNOPSIS
  918.     error = MWLMeshMaterialAdd( meshhandle,materialhandle )
  919.                                 D1         D2
  920.  
  921.     ULONG MWLMeshMaterialAdd
  922.          ( ULONG,ULONG * );
  923.  
  924.    FUNCTION
  925.     A new material will be created and added to the mesh. You will get a handle to it.
  926.     All material properties will be set to 0.
  927.  
  928.    INPUTS
  929.      meshhandle     - A valid handle of a mesh.
  930.     materialhandle - Pointer to a variable which will contain 
  931.                      the handle to the new material.
  932.     
  933.    RESULT
  934.      error - RCNOERROR  if all went well.
  935.             RCNOMESH   if the handle is not valid.
  936.             RCNOMEMORY if there is not enough memory. 
  937.  
  938.    EXAMPLE
  939.     error = MWLMeshMaterialAdd(meshhandle,&mylong);
  940.  
  941.    NOTES
  942.     A default name will be assigned to the new material.
  943.     Like MWLMATX, where X is an internal count of the material.
  944.  
  945.    BUGS
  946.  
  947.    SEE ALSO
  948.      MWLMeshMaterialNameSet(),MWLMeshMaterialAmbientColorSet(),
  949.    MWLMeshMaterialDiffuseColorSet(),MWLMeshMaterialShininessSet()
  950.     MWLMeshMaterialTransparencySet()
  951.  
  952. meshwriter.library/MWLMeshMaterialAmbientColorGet           meshwriter.library/MWLMeshMaterialAmbientColorGet
  953.  
  954.    NAME    
  955.      MWLMeshMaterialAmbientColorGet -- Get the ambient color of a material.
  956.  
  957.    SYNOPSIS
  958.     error = MWLMeshMaterialAmbientColorGet( meshhandle,materialhandle,color )
  959.                                             D1         D2              A0
  960.  
  961.     ULONG MWLMeshMaterialAmbientColorGet
  962.          ( ULONG,ULONG,TOCLColor * );
  963.  
  964.    FUNCTION
  965.     The ambient color of the material will be written in the passed color structure.
  966.  
  967.    INPUTS
  968.      meshhandle      - A valid handle of a mesh.
  969.     materialhandle  - A valid handle of a material.
  970.     color           - Pointer to a color structure which will contain
  971.                       the color information.
  972.     
  973.    RESULT
  974.      error - RCNOERROR    if all went well.
  975.             RCNOMESH     if the handle is not valid.
  976.             RCNOMATERIAL if the handle is not valid.
  977.  
  978.    EXAMPLE
  979.     error = MWLMeshMaterialAmbientColorGet(meshhandle,materialhandle,&mycolor);
  980.  
  981.    NOTES
  982.  
  983.    BUGS
  984.  
  985.    SEE ALSO
  986.      MWLMeshMaterialAmbientColorSet()
  987.  
  988. meshwriter.library/MWLMeshMaterialAmbientColorSet           meshwriter.library/MWLMeshMaterialAmbientColorSet
  989.  
  990.    NAME    
  991.      MWLMeshMaterialAmbientColorSet -- Set the ambient color of a material.
  992.  
  993.    SYNOPSIS
  994.     error = MWLMeshMaterialAmbientColorSet( meshhandle,materialhandle,color )
  995.                                             D1         D2              A0
  996.  
  997.     ULONG MWLMeshMaterialAmbientColorSet
  998.          ( ULONG,ULONG,TOCLColor * );
  999.  
  1000.    FUNCTION
  1001.     The ambient color of the material will be set to the values passed by the
  1002.     color structure.
  1003.  
  1004.    INPUTS
  1005.      meshhandle      - A valid handle of a mesh.
  1006.     materialhandle  - A valid handle of a material.
  1007.     color           - Pointer to a color structure containing the color information.
  1008.     
  1009.    RESULT
  1010.      error - RCNOERROR    if all went well.
  1011.             RCNOMESH     if the handle is not valid.
  1012.             RCNOMATERIAL if the handle is not valid.
  1013.  
  1014.    EXAMPLE
  1015.     error = MWLMeshMaterialAmbientColorSet(meshhandle,materialhandle,&mycolor);
  1016.  
  1017.    NOTES
  1018.  
  1019.    BUGS
  1020.  
  1021.    SEE ALSO
  1022.      MWLMeshMaterialAmbientColorGet()
  1023.  
  1024. meshwriter.library/MWLMeshMaterialDiffuseColorGet           meshwriter.library/MWLMeshMaterialDiffuseColorGet
  1025.  
  1026.    NAME    
  1027.      MWLMeshMaterialDiffuseColorGet -- Get the diffuse color of a material.
  1028.  
  1029.    SYNOPSIS
  1030.     error = MWLMeshMaterialDiffuseColorGet( meshhandle,materialhandle,color )
  1031.                                             D1         D2              A0
  1032.  
  1033.     ULONG MWLMeshMaterialDiffuseColorGet
  1034.          ( ULONG,ULONG,TOCLColor * );
  1035.  
  1036.    FUNCTION
  1037.     The diffuse color of the material will be written in the passed color structure.
  1038.  
  1039.    INPUTS
  1040.      meshhandle      - A valid handle of a mesh.
  1041.     materialhandle  - A valid handle of a material.
  1042.     color           - Pointer to a color structure which will contain
  1043.                       the color information.
  1044.     
  1045.    RESULT
  1046.      error - RCNOERROR    if all went well.
  1047.             RCNOMESH     if the handle is not valid.
  1048.             RCNOMATERIAL if the handle is not valid.
  1049.  
  1050.    EXAMPLE
  1051.     error = MWLMeshMaterialDiffuseColorGet(meshhandle,materialhandle,&mycolor);
  1052.  
  1053.    NOTES
  1054.  
  1055.    BUGS
  1056.  
  1057.    SEE ALSO
  1058.      MWLMeshMaterialDiffuseColorSet()
  1059.  
  1060. meshwriter.library/MWLMeshMaterialDiffuseColorSet           meshwriter.library/MWLMeshMaterialDiffuseColorSet
  1061.  
  1062.    NAME    
  1063.      MWLMeshMaterialDiffuseColorSet -- Set the diffuse color of a material.
  1064.  
  1065.    SYNOPSIS
  1066.     error = MWLMeshMaterialDiffuseColorSet( meshhandle,materialhandle,color )
  1067.                                             D1         D2              A0
  1068.  
  1069.     ULONG MWLMeshMaterialDiffuseColorSet
  1070.          ( ULONG,ULONG,TOCLColor * );
  1071.  
  1072.    FUNCTION
  1073.     The diffuse color of the material will be set to the values passed by the
  1074.     color structure.
  1075.  
  1076.    INPUTS
  1077.      meshhandle      - A valid handle of a mesh.
  1078.     materialhandle  - A valid handle of a material.
  1079.     color           - Pointer to a color structure containing the color information.
  1080.     
  1081.    RESULT
  1082.      error - RCNOERROR    if all went well.
  1083.             RCNOMESH     if the handle is not valid.
  1084.             RCNOMATERIAL if the handle is not valid.
  1085.  
  1086.    EXAMPLE
  1087.     error = MWLMeshMaterialDiffuseColorSet(meshhandle,materialhandle,&mycolor);
  1088.  
  1089.    NOTES
  1090.  
  1091.    BUGS
  1092.  
  1093.    SEE ALSO
  1094.      MWLMeshMaterialDiffuseColorGet()
  1095.  
  1096. meshwriter.library/MWLMeshMaterialNameGet                           meshwriter.library/MWLMeshMaterialNameGet
  1097.  
  1098.    NAME    
  1099.      MWLMeshMaterialNameGet -- Get the name of a material.
  1100.  
  1101.    SYNOPSIS
  1102.     error = MWLMeshMaterialNameGet( meshhandle,materialhandle,name )
  1103.                                     D1         D2             D3
  1104.  
  1105.     ULONG MWLMeshMaterialNameGet
  1106.          ( ULONG,ULONG,STRPTR * );
  1107.  
  1108.    FUNCTION
  1109.     You will get a pointer to the name of the material. This string is READ_ONLY
  1110.     and only valid as long as the mesh exists.
  1111.  
  1112.    INPUTS
  1113.      meshhandle     - A valid handle of a mesh.
  1114.     materialhandle - A valid handle of a material.
  1115.     name           - Pointer to the name of the material.
  1116.     
  1117.    RESULT
  1118.      error - RCNOERROR    if all went well.
  1119.             RCNOMESH     if the handle is not valid.
  1120.             RCNOMATERIAL if the handle is not valid.
  1121.  
  1122.    EXAMPLE
  1123.     error = MWLMeshMaterialNameGet(meshhandle,materialhandle,&mystring);
  1124.  
  1125.    NOTES
  1126.  
  1127.    BUGS
  1128.  
  1129.    SEE ALSO
  1130.      MWLMeshMaterialNameSet()
  1131.  
  1132. meshwriter.library/MWLMeshMaterialNameSet                           meshwriter.library/MWLMeshMaterialNameSet
  1133.  
  1134.    NAME    
  1135.      MWLMeshMaterialNameSet -- Set the name of the material.
  1136.  
  1137.    SYNOPSIS
  1138.     error = MWLMeshMaterialNameSet( meshhandle,materialhandle,materialname )
  1139.                                     D1         D2             D3
  1140.  
  1141.     ULONG MWLMeshMaterialNameSet
  1142.          ( ULONG,ULONG,STRPTR );
  1143.  
  1144.    FUNCTION
  1145.     A copy of the passed string will be made and assigned to the material its
  1146.     name string.
  1147.  
  1148.    INPUTS
  1149.      meshhandle      - A valid handle of a mesh.
  1150.     materialhandle  - A valid handle of a material.
  1151.     materialname    - String which contains the name.
  1152.     
  1153.    RESULT
  1154.      error - RCNOERROR    if all went well.
  1155.             RCNOMESH     if the handle is not valid.
  1156.             RCNOMATERIAL if the handle is not valid.
  1157.              RCNOMEMORY   if there is not enough memory.
  1158.  
  1159.    EXAMPLE
  1160.     error = MWLMeshMaterialNameSet(meshhandle,materialhandle,"DeepBlue");
  1161.  
  1162.    NOTES
  1163.     This function can be called as often as you need which will
  1164.     replace the old value.
  1165.  
  1166.     Not all formats support names, and the written length of the
  1167.     string depends of the format too.
  1168.  
  1169.    BUGS
  1170.  
  1171.    SEE ALSO
  1172.      MWLMeshMaterialNameGet()
  1173.  
  1174. meshwriter.library/MWLMeshMaterialShininessGet                 meshwriter.library/MWLMeshMaterialShininessGet
  1175.  
  1176.    NAME    
  1177.      MWLMeshMaterialShininessGet -- Get the shininess of a material.
  1178.  
  1179.    SYNOPSIS
  1180.     error = MWLMeshMaterialShininessGet( meshhandle,materialhandle,shininess )
  1181.                                          D1         D2             D3
  1182.  
  1183.     ULONG MWLMeshMaterialShininessGet
  1184.          ( ULONG,ULONG,TOCLFloat * );
  1185.  
  1186.    FUNCTION
  1187.     The shininess of the material will be put into the variable pointed by shininess.
  1188.  
  1189.    INPUTS
  1190.      meshhandle      - A valid handle of a mesh.
  1191.     materialhandle  - A valid handle of a material.
  1192.     shininess       - Pointer to the variable which will contain the shininess.
  1193.     
  1194.    RESULT
  1195.      error - RCNOERROR         if all went well.
  1196.             RCNOMESH          if the handle is not valid.
  1197.             RCNOMATERIAL      if the handle is not valid.
  1198.  
  1199.    EXAMPLE
  1200.     error = MWLMeshMaterialShininessGet(meshhandle,materialhandle,&myfloat);
  1201.  
  1202.    NOTES
  1203.  
  1204.    BUGS
  1205.  
  1206.    SEE ALSO
  1207.      MWLMeshMaterialShininessSet()
  1208.  
  1209. meshwriter.library/MWLMeshMaterialShininessSet                 meshwriter.library/MWLMeshMaterialShininessSet
  1210.  
  1211.    NAME    
  1212.      MWLMeshMaterialShininessSet -- Set the shininess of a material.
  1213.  
  1214.    SYNOPSIS
  1215.     error = MWLMeshMaterialShininessSet( meshhandle,materialhandle,shininess )
  1216.                                          D1         D2             D3
  1217.  
  1218.     ULONG MWLMeshMaterialShininessSet
  1219.          ( ULONG,ULONG,TOCLFloat );
  1220.  
  1221.    FUNCTION
  1222.     The shininess of the material will be set to the value passed by
  1223.     shininess.
  1224.  
  1225.    INPUTS
  1226.      meshhandle      - A valid handle of a mesh.
  1227.     materialhandle  - A valid handle of a material.
  1228.     shininess       - Value of the shininess between 0.0 and 1.0.
  1229.     
  1230.    RESULT
  1231.      error - RCNOERROR         if all went well.
  1232.             RCNOMESH          if the handle is not valid.
  1233.             RCNOMATERIAL      if the handle is not valid.
  1234.             RCVALUEOUTOFRANGE if the value is out of range.
  1235.  
  1236.    EXAMPLE
  1237.     error = MWLMeshMaterialShininessSet(meshhandle,materialhandle,0.34);
  1238.  
  1239.    NOTES
  1240.  
  1241.    BUGS
  1242.  
  1243.    SEE ALSO
  1244.      MWLMeshMaterialShininessGet()
  1245.  
  1246. meshwriter.library/MWLMeshMaterialTransparencyGet           meshwriter.library/MWLMeshMaterialTransparencyGet
  1247.  
  1248.    NAME    
  1249.      MWLMeshMaterialTransparencyGet -- Get the transparency of a material.
  1250.  
  1251.    SYNOPSIS
  1252.     error = MWLMeshMaterialTransparencyGet( meshhandle,materialhandle,transparency )
  1253.                                             D1         D2             D3
  1254.  
  1255.     ULONG MWLMeshMaterialTransparencyGet
  1256.          ( ULONG,ULONG,TOCLFloat * );
  1257.  
  1258.    FUNCTION
  1259.     The transparency of the material will be put into the variable pointed by transparency.
  1260.  
  1261.    INPUTS
  1262.      meshhandle      - A valid handle of a mesh.
  1263.     materialhandle  - A valid handle of a material.
  1264.     transparency    - Pointer to the variable which will contain the transparency.
  1265.     
  1266.    RESULT
  1267.      error - RCNOERROR         if all went well.
  1268.             RCNOMESH          if the handle is not valid.
  1269.             RCNOMATERIAL      if the handle is not valid.
  1270.  
  1271.    EXAMPLE
  1272.     error = MWLMeshMaterialTransparencyGet(meshhandle,materialhandle,&myfloat);
  1273.  
  1274.    NOTES
  1275.  
  1276.    BUGS
  1277.  
  1278.    SEE ALSO
  1279.      MWLMeshMaterialTransparencySet()
  1280.  
  1281. meshwriter.library/MWLMeshMaterialTransparencySet           meshwriter.library/MWLMeshMaterialTransparencySet
  1282.  
  1283.    NAME    
  1284.      MWLMeshMaterialTransparencySet -- Set the transparency of a material.
  1285.  
  1286.    SYNOPSIS
  1287.     error = MWLMeshMaterialTransparencySet( meshhandle,materialhandle,transparency )
  1288.                                             D1         D2             D3
  1289.  
  1290.     ULONG MWLMeshMaterialTransparencySet
  1291.          ( ULONG,ULONG,TOCLFloat );
  1292.  
  1293.    FUNCTION
  1294.     The transparency of the material will be set to the value passed by
  1295.     transparency.
  1296.  
  1297.    INPUTS
  1298.      meshhandle      - A valid handle of a mesh.
  1299.     materialhandle  - A valid handle of a material.
  1300.     transparency    - Value of the transparency between 0.0 and 1.0.
  1301.     
  1302.    RESULT
  1303.      error - RCNOERROR         if all went well.
  1304.             RCNOMESH          if the handle is not valid.
  1305.             RCNOMATERIAL      if the handle is not valid.
  1306.             RCVALUEOUTOFRANGE if the value is out of range.
  1307.  
  1308.    EXAMPLE
  1309.     error = MWLMeshMaterialTransparencySet(meshhandle,materialhandle,0.9);
  1310.  
  1311.    NOTES
  1312.  
  1313.    BUGS
  1314.  
  1315.    SEE ALSO
  1316.      MWLMeshMaterialTransparencyGet()
  1317.  
  1318. meshwriter.library/MWLMeshNameGet                                           meshwriter.library/MWLMeshNameGet
  1319.  
  1320.    NAME    
  1321.      MWLMeshNameGet -- Get the name of a mesh.
  1322.  
  1323.    SYNOPSIS
  1324.     error = MWLMeshNameGet( meshhandle,name )
  1325.                             D1         D2
  1326.  
  1327.     ULONG MWLMeshNameGet
  1328.          ( ULONG,STRPTR * );
  1329.  
  1330.    FUNCTION
  1331.     You will get a pointer to the name of the mesh. This string is READ_ONLY
  1332.     and only valid as long the as mesh exists.
  1333.  
  1334.    INPUTS
  1335.      meshhandle    - A valid handle of a mesh.
  1336.     name          - Pointer to the name of the mesh.
  1337.     
  1338.    RESULT
  1339.      error - RCNOERROR if all went well.
  1340.             RCNOMESH  if the handle is not valid.
  1341.  
  1342.    EXAMPLE
  1343.     error = MWLMeshNameGet(meshhandle,&mystring);
  1344.  
  1345.    NOTES
  1346.  
  1347.    BUGS
  1348.  
  1349.    SEE ALSO
  1350.      MWLMeshNameSet()
  1351.  
  1352. meshwriter.library/MWLMeshNameSet                                           meshwriter.library/MWLMeshNameSet
  1353.  
  1354.    NAME    
  1355.      MWLMeshNameSet -- Set the name of the mesh.
  1356.  
  1357.    SYNOPSIS
  1358.     error = MWLMeshNameSet( meshhandle,name )
  1359.                             D1         D2
  1360.  
  1361.     ULONG MWLMeshNameSet
  1362.          ( ULONG,STRPTR );
  1363.  
  1364.    FUNCTION
  1365.     A copy of the passed string will be made and assigned to the mesh its
  1366.     name string.
  1367.  
  1368.    INPUTS
  1369.      meshhandle      - A valid handle of a mesh.
  1370.     name            - String which contains the name.
  1371.     
  1372.    RESULT
  1373.      error - RCNOERROR  if all went well.
  1374.             RCNOMESH   if the handle is not valid.
  1375.              RCNOMEMORY if there is not enough memory.
  1376.  
  1377.    EXAMPLE
  1378.     error = MWLMeshNameSet(meshhandle,"GreatShape");
  1379.  
  1380.    NOTES
  1381.     This function can be called as often as you need, which will
  1382.     replace the old value.
  1383.  
  1384.     Not all formats support names, and the written length of the
  1385.     string depends of the format too.
  1386.  
  1387.    BUGS
  1388.  
  1389.    SEE ALSO
  1390.      MWLMeshNameGet()
  1391.  
  1392. meshwriter.library/MWLMeshNew                                                   meshwriter.library/MWLMeshNew
  1393.  
  1394.    NAME    
  1395.      MWLMeshNew -- Creates a new mesh
  1396.  
  1397.    SYNOPSIS
  1398.     meshhandle = MWLMeshNew( )
  1399.               
  1400.  
  1401.     ULONG MWLMeshNew
  1402.          ( );
  1403.  
  1404.    FUNCTION
  1405.     Allocates the memory for a new mesh, initializes all its contents and
  1406.     returns a handle to the new mesh. The mesh has to be deleted after usage
  1407.     with MWLMeshDelete().   
  1408.  
  1409.    INPUTS
  1410.  
  1411.    RESULT
  1412.      meshhandle - A handle to the new mesh, or 0 in error case, which means
  1413.                  that there is not enough memory available.
  1414.  
  1415.    EXAMPLE
  1416.  
  1417.    NOTES
  1418.  
  1419.    BUGS
  1420.  
  1421.    SEE ALSO
  1422.      MWLMeshDelete()
  1423.  
  1424. meshwriter.library/MWLMeshNumberOfMaterialsGet                 meshwriter.library/MWLMeshNumberOfMaterialsGet
  1425.  
  1426.    NAME    
  1427.      MWLMeshNumberOfMaterialsGet -- Get the number of materials in a mesh.
  1428.  
  1429.    SYNOPSIS
  1430.     number = MWLMeshNumberOfMaterialsGet( meshhandle )
  1431.                                           D1
  1432.  
  1433.     ULONG MWLMeshNumberOfMaterialsGet
  1434.          ( ULONG )
  1435.  
  1436.    FUNCTION
  1437.     The current number of materials found in the mesh will be returned.
  1438.  
  1439.    INPUTS
  1440.      meshhandle      - A valid handle of a mesh.
  1441.     
  1442.    RESULT
  1443.      number - Number of materials, 0 if any or no valid mesh.
  1444.  
  1445.    EXAMPLE
  1446.     number = MWLMeshNumberOfMaterialsGet(meshhandle);
  1447.  
  1448.    NOTES
  1449.  
  1450.    BUGS
  1451.  
  1452.    SEE ALSO
  1453.      MWLMeshNumberOfPolygonsGet(),MWLMeshNumberOfVerticesGet()
  1454.  
  1455. meshwriter.library/MWLMeshNumberOfPolygonsGet                   meshwriter.library/MWLMeshNumberOfPolygonsGet
  1456.  
  1457.    NAME    
  1458.      MWLMeshNumberOfPolygonsGet -- Get the number of polygons in a mesh.
  1459.  
  1460.    SYNOPSIS
  1461.     number = MWLMeshNumberOfPolygonsGet( meshhandle )
  1462.                                          D1
  1463.  
  1464.     ULONG MWLMeshNumberOfPolygonsGet
  1465.          ( ULONG )
  1466.  
  1467.    FUNCTION
  1468.     The current number of polygons found in the mesh will be returned.
  1469.  
  1470.    INPUTS
  1471.      meshhandle      - A valid handle of a mesh.
  1472.     
  1473.    RESULT
  1474.      number - Number of polygons, 0 if any or no valid mesh.
  1475.  
  1476.    EXAMPLE
  1477.     number = MWLMeshNumberOfPolygonsGet(meshhandle);
  1478.  
  1479.    NOTES
  1480.  
  1481.    BUGS
  1482.  
  1483.    SEE ALSO
  1484.      MWLMeshNumberOfMaterialsGet(),MWLMeshNumberOfVerticesGet()
  1485.  
  1486. meshwriter.library/MWLMeshNumberOfVerticesGet                   meshwriter.library/MWLMeshNumberOfVerticesGet
  1487.  
  1488.    NAME    
  1489.      MWLMeshNumberOfVerticesGet -- Get the number of vertices in a mesh.
  1490.  
  1491.    SYNOPSIS
  1492.     number = MWLMeshNumberOfVerticesGet( meshhandle )
  1493.                                          D1
  1494.  
  1495.     ULONG MWLMeshNumberOfVerticesGet
  1496.          ( ULONG )
  1497.  
  1498.    FUNCTION
  1499.     The current number of vertices found in the mesh will be returned.
  1500.  
  1501.    INPUTS
  1502.      meshhandle      - A valid handle of a mesh.
  1503.     
  1504.    RESULT
  1505.      number - Number of vertices, 0 if any or no valid mesh.
  1506.  
  1507.    EXAMPLE
  1508.     number = MWLMeshNumberOfVerticesGet(meshhandle);
  1509.  
  1510.    NOTES
  1511.  
  1512.    BUGS
  1513.  
  1514.    SEE ALSO
  1515.      MWLMeshNumberOfMaterialsGet(),MWLMeshNumberOfPolygonsGet()
  1516.  
  1517. meshwriter.library/MWLMeshPolygonAdd                                     meshwriter.library/MWLMeshPolygonAdd
  1518.  
  1519.    NAME    
  1520.      MWLMeshPolygonAdd -- Add a new polygon to the mesh.
  1521.  
  1522.    SYNOPSIS
  1523.     error = MWLMeshPolygonAdd( meshhandle,materialhandle )
  1524.                                D1         D2
  1525.  
  1526.     ULONG MWLMeshPolygonAdd
  1527.          ( ULONG,ULONG );
  1528.  
  1529.    FUNCTION
  1530.     A new polygon will be created and added to the mesh.
  1531.     With MWLMeshPolygonVertexAdd you can add vertices to this polygon.
  1532.  
  1533.    INPUTS
  1534.      meshhandle     - A valid handle of a mesh.
  1535.     materialhandle - A valid handle of a material or 0 if you wont
  1536.                      assign a material to this polygon now.
  1537.     
  1538.    RESULT
  1539.      error - RCNOERROR    if all went well.
  1540.             RCNOMESH     if the handle is not valid.
  1541.             RCNOMATERIAL if the handle is not valid.
  1542.             RCNOMEMORY   if there is not enough memory. 
  1543.  
  1544.    EXAMPLE
  1545.     error = MWLMeshPolygonAdd(meshhandle,materialhandle);
  1546.  
  1547.    NOTES
  1548.     Only convex polygons are supported.
  1549.  
  1550.         Correct              Incorrect
  1551.  
  1552.         *-----*              *----*
  1553.        / \   /                \  /
  1554.       /   \ /                  \/
  1555.      / __--*                   /\
  1556.     *--                       /  \
  1557.                              *----*
  1558.  
  1559.    BUGS
  1560.  
  1561.    SEE ALSO
  1562.      MWLMeshPolygonMaterialSet(),MWLMeshPolygonVertexAdd()
  1563.  
  1564. meshwriter.library/MWLMeshPolygonMaterialSet                     meshwriter.library/MWLMeshPolygonMaterialSet
  1565.  
  1566.    NAME    
  1567.      MWLMeshPolygonMaterialSet -- Set the material of the most recent polygon.
  1568.  
  1569.    SYNOPSIS
  1570.     error = MWLMeshPolygonMaterialSet( meshhandle,materialhandle )
  1571.                                        D1         D2
  1572.  
  1573.     ULONG MWLMeshPolygonMaterialSet
  1574.          ( ULONG,ULONG );
  1575.  
  1576.    FUNCTION
  1577.     The material of the most recent polygon will be set to the one you
  1578.     pass by the handle.
  1579.  
  1580.    INPUTS
  1581.      meshhandle      - A valid handle of a mesh.
  1582.     materialhandle  - A valid handle of a material.
  1583.     
  1584.    RESULT
  1585.      error - RCNOERROR    if all went well.
  1586.             RCNOMESH     if the handle is not valid.
  1587.             RCNOMATERIAL if the handle is not valid.
  1588.             RCNOPOLYGON  if there is no polygon to work with.     
  1589.  
  1590.    EXAMPLE
  1591.     error = MWLMeshPolygonMaterialSet(meshhandle,materialhandle);
  1592.  
  1593.    NOTES
  1594.     As all is a polygon, after calling MWLMeshTriangleAdd() with this
  1595.     function you can set the material of the new triangle too.
  1596.  
  1597.    BUGS
  1598.  
  1599.    SEE ALSO
  1600.      MWLMeshPolygonAdd(),MWLMeshTriangleAdd()
  1601.  
  1602. meshwriter.library/MWLMeshPolygonVertexAdd                         meshwriter.library/MWLMeshPolygonVertexAdd
  1603.  
  1604.    NAME    
  1605.      MWLMeshPolygonVertexAdd -- Add a new vertex to the most recent polygon,
  1606.                                according the CTM.
  1607.  
  1608.    SYNOPSIS
  1609.     error = MWLMeshPolygonVertexAdd( meshhandle,vertex )
  1610.                                      D1          A0
  1611.  
  1612.     ULONG MWLMeshPolygonAdd
  1613.          ( ULONG,TOCLVertex * );
  1614.  
  1615.    FUNCTION
  1616.     A new vertex will be added to the polygon. A copy of the contents passed
  1617.     by the vertex pointer will be made.
  1618.  
  1619.    INPUTS
  1620.      meshhandle   - A valid handle of a mesh.
  1621.     vertex       - Pointer to a vertex structure which contains the coordinates
  1622.                    of the new vertex.
  1623.     
  1624.    RESULT
  1625.      error - RCNOERROR    if all went well.
  1626.             RCNOMESH     if the handle is not valid.
  1627.             RCNOMEMORY   if there is not enough memory. 
  1628.             RCNOPOLYGON  if there is no polygon to work with.
  1629.  
  1630.    EXAMPLE
  1631.     error = MWLMeshPolygonVertexAdd(meshhandle,&myvertex);
  1632.  
  1633.    NOTES
  1634.     Vertices have to be added in counterclock wise direction.
  1635.  
  1636.           v3
  1637.          / |
  1638.         /  |
  1639.        /   |
  1640.       /    |
  1641.      /     |
  1642.     v1--->v2
  1643.  
  1644.  
  1645.    BUGS
  1646.  
  1647.    SEE ALSO
  1648.      MWLMeshPolygonAdd()
  1649.  
  1650. meshwriter.library/MWLMeshPolygonVertexAssign                   meshwriter.library/MWLMeshPolygonVertexAssign
  1651.  
  1652.    NAME    
  1653.      MWLMeshPolygonVertexAssign -- Assigns an existing vertex to the most recent polygon.
  1654.  
  1655.    SYNOPSIS
  1656.     error = MWLMeshPolygonVertexAssign ( meshhandle,index )
  1657.                                          D1         D2
  1658.  
  1659.     ULONG MWLMeshPolygonAssign
  1660.          ( ULONG,ULONG );
  1661.  
  1662.    FUNCTION
  1663.     An already existing vertex will be assigned to the polygon.
  1664.  
  1665.    INPUTS
  1666.      meshhandle   - A valid handle of a mesh.
  1667.     index        - The index of the vertex.
  1668.     
  1669.    RESULT
  1670.      error - RCNOERROR    if all went well.
  1671.             RCNOMESH     if the handle is not valid.
  1672.             RCNOMEMORY   if there is not enough memory. 
  1673.             RCNOPOLYGON  if there is no polygon to work with.
  1674.             RCNOVERTEX   if the vertex is not existing.
  1675.  
  1676.    EXAMPLE
  1677.     error = MWLMeshPolygonVertexAssign(meshhandle,index);
  1678.  
  1679.    NOTES
  1680.     Vertices have to be assigned in counterclock wise direction.
  1681.  
  1682.           v3
  1683.          / |
  1684.         /  |
  1685.        /   |
  1686.       /    |
  1687.      /     |
  1688.     v1--->v2
  1689.  
  1690.  
  1691.    BUGS
  1692.  
  1693.    SEE ALSO
  1694.      MWLMeshVertexAdd()
  1695.  
  1696. meshwriter.library/MWLMeshRotationChange                             meshwriter.library/MWLMeshRotationChange
  1697.  
  1698.    NAME    
  1699.      MWLMeshRotationChange -- Changes the rotation of the CTM of the mesh.
  1700.  
  1701.    SYNOPSIS
  1702.     error = MWLMeshRotationChange( meshhandle,rotation,operation )
  1703.                                    D1          A0      D2
  1704.  
  1705.     ULONG MWLMeshRotationChange
  1706.          ( ULONG,TOCLVertex *,ULONG );
  1707.  
  1708.    FUNCTION
  1709.     The rotation of the CTM will be modified in function of the rotation
  1710.     and the operation to perform.
  1711.  
  1712.    INPUTS
  1713.      meshhandle - A valid handle of a mesh.
  1714.     rotation   - Pointer to a vertex structure which contains the angles in radian
  1715.                  of the rotation.
  1716.     operation  - A valid CTM operation.
  1717.                   CTMADD,CTMSUB,CTMMUL
  1718.                  CTMDIV,CTMSET,CTMRESET
  1719.  
  1720.    RESULT
  1721.      error - RCNOERROR          if all went well.
  1722.             RCNOMESH           if the handle is not valid.
  1723.             RCINVALIDOPERATION if the operation is not value.
  1724.  
  1725.    EXAMPLE
  1726.     error = MWLMeshRotationChange(meshhandle,&myrotation,myoperation);
  1727.  
  1728.    NOTES
  1729.     If you pass 0 values for a division operation,
  1730.     the corresponding CTM entry will be set to 0.
  1731.  
  1732.    BUGS
  1733.  
  1734.    SEE ALSO
  1735.      MWLMeshTranslationChange(), MWLMeshTranslationGet()
  1736.     MWLMeshCTMReset(),MWLMeshRotationGet()
  1737.     MWLMeshScaleChange(),MWLMeshScaleGet()
  1738.  
  1739. meshwriter.library/MWLMeshRotationGet                                   meshwriter.library/MWLMeshRotationGet
  1740.  
  1741.    NAME    
  1742.      MWLMeshRotationGet -- Get the rotation of the mesh its CTM.
  1743.  
  1744.    SYNOPSIS
  1745.     error = MWLMeshRotationGet( meshhandle,rotation )
  1746.                                 D1          A0
  1747.  
  1748.     ULONG MWLMeshRotationGet
  1749.          ( ULONG,TOCLVertex * );
  1750.  
  1751.    FUNCTION
  1752.     The rotation of the CTM will be returned in the passed vertex structure.
  1753.  
  1754.    INPUTS
  1755.      meshhandle - A valid handle of a mesh.
  1756.     rotation   - Pointer to a vertex structure which will contain the
  1757.                  rotation angles in radian.
  1758.  
  1759.    RESULT
  1760.      error - RCNOERROR          if all went well.
  1761.             RCNOMESH           if the handle is not valid.
  1762.  
  1763.    EXAMPLE
  1764.     error = MWLMeshRotationGet(meshhandle,&myrotation);
  1765.  
  1766.    NOTES
  1767.  
  1768.    BUGS
  1769.  
  1770.    SEE ALSO
  1771.      MWLMeshtranslationChange(), MWLMeshTranslationChange()
  1772.     MWLMeshRotationChange(),MWLMeshCTMReset()
  1773.     MWLMeshScaleChange(),MWLMeshScaleGet()
  1774.  
  1775. meshwriter.library/MWLMeshSave2D                                             meshwriter.library/MWLMeshSave2D
  1776.  
  1777.    NAME    
  1778.      MWLMeshSave2D -- Saves the mesh as 2D file.
  1779.  
  1780.    SYNOPSIS
  1781.     error = MWLMeshSave2D( meshhandle,id,filename,viewtype,drawmode,taglist )
  1782.                            D1         D2 D3       D4       D5        A0
  1783.  
  1784.     ULONG MWLMeshSave2D
  1785.          ( ULONG,ULONG,STRPTR,ULONG,ULONG,struct TagItem * );
  1786.  
  1787.    FUNCTION
  1788.     The mesh, this means vertices, polygons, materials, camera and light will
  1789.     be used to generate and save a 2D file from a specific view point and
  1790.     drawing mode.
  1791.  
  1792.    INPUTS
  1793.      meshhandle  - A valid handle of a mesh.
  1794.     id          - A valid 2D file format id, to spedify the output format.
  1795.     filename    - Name and path of the file.
  1796.     viewtype    - Type of view, like perspective ...
  1797.     drawmode    - Type of drawing, points, lines, surfaces ...
  1798.     taglist     - NULL, for future use.
  1799.     
  1800.    RESULT
  1801.     error - RCNOERROR         if all went well.
  1802.             RCNOMESH          if the handle is not valid.
  1803.             RCUNKNOWNFTYPE    if the id is not known.
  1804.             RCUNKNOWNDMODE    if the view mode in not known.
  1805.             RCNOPOLYGON       if there are no polygons to save.
  1806.             RCCHGBUF          if an error occured to allocate the save buffer.
  1807.             RCWRITEDATA       if an error occured while writing data, no more space...
  1808.             RCVERTEXOVERFLOW  if the format does not support as much vertices.
  1809.             IoErr()           if possible to catch it, you will get its codes.
  1810.  
  1811.    EXAMPLE
  1812.     error = MWLMeshSave2D(meshhandle,id,"ram:test",TVWPERSP,dm,NULL);
  1813.  
  1814.    NOTES
  1815.     No file existence tests are made here! Existent files will be overwritten.
  1816.  
  1817.    BUGS
  1818.  
  1819.    SEE ALSO
  1820.      MWL2DFileFormatIDGet(),MWLDrawModeGet(),MWLMeshSave3D()
  1821.  
  1822. meshwriter.library/MWLMeshSave3D                                             meshwriter.library/MWLMeshSave3D
  1823.  
  1824.    NAME    
  1825.      MWLMeshSave3D -- Saves the mesh as 3D file..
  1826.  
  1827.    SYNOPSIS
  1828.     error = MWLMeshSave3D( meshhandle,id,filename,taglist )
  1829.                            D1         D2 D3        A0
  1830.  
  1831.     ULONG MWLMeshSave3D
  1832.          ( ULONG,ULONG,STRPTR,struct TagItem * );
  1833.  
  1834.    FUNCTION
  1835.     The mesh, this means vertices, polygons, materials, camera and light will
  1836.     be saved in the specified 3d file format.
  1837.  
  1838.    INPUTS
  1839.      meshhandle  - A valid handle of a mesh.
  1840.     id          - A valid 3D file format id, to spedify the output format.
  1841.     filename    - Name and path of the file.
  1842.     taglist     - NULL, for future use.
  1843.     
  1844.    RESULT
  1845.     error - RCNOERROR                  if all went well.
  1846.             RCNOMESH                   if the handle is not valid.
  1847.             RCUNKNOWNFTYPE             if the id is not known.
  1848.             RCNOPOLYGON                if there are no polygons to save.
  1849.             RCCHGBUF                   if an error occured to allocate the save buffer.
  1850.             RCWRITEDATA                if an error occured while writing data, no more space...
  1851.             RCVERTEXOVERFLOW           if the format does not support as much vertices.
  1852.             RCVERTEXINPOLYGONOVERFLOW  if the format does not support as much vertices in a polygon.
  1853.             IoErr()                    if possible to catch it, you will get its codes.
  1854.  
  1855.    EXAMPLE
  1856.     error = MWLMeshSave3D(meshhandle,id,"ram:test",NULL);
  1857.  
  1858.    NOTES
  1859.     No file existence tests are made here! Existent files will be overwritten.
  1860.  
  1861.    BUGS
  1862.  
  1863.    SEE ALSO
  1864.      MWL3DFileFormatIDGet(),MWLMeshSave2D()
  1865.  
  1866. meshwriter.library/MWLMeshScaleChange                                   meshwriter.library/MWLMeshScaleChange
  1867.  
  1868.    NAME    
  1869.      MWLMeshScaleChange -- Changes the scale of the CTM of the mesh.
  1870.  
  1871.    SYNOPSIS
  1872.     error = MWLMeshScaleChange( meshhandle,scale,operation )
  1873.                                 D1          A0   D2
  1874.  
  1875.     ULONG MWLMeshScaleChange
  1876.          ( ULONG,TOCLVertex *,ULONG );
  1877.  
  1878.    FUNCTION
  1879.     The scale of the CTM will be modified in function of the scale
  1880.     and the operation to perform.
  1881.  
  1882.    INPUTS
  1883.      meshhandle  - A valid handle of a mesh.
  1884.     scale       - Pointer to a vertex structure which contains the factor
  1885.                   of the scaling.
  1886.     operation   - A valid CTM operation.
  1887.                    CTMADD,CTMSUB,CTMMUL
  1888.                   CTMDIV,CTMSET,CTMRESET
  1889.  
  1890.    RESULT
  1891.      error - RCNOERROR          if all went well.
  1892.             RCNOMESH           if the handle is not valid.
  1893.             RCINVALIDOPERATION if the operation is not value.
  1894.  
  1895.    EXAMPLE
  1896.     error = MWLMeshScaleChange(meshhandle,&myscale,myoperation);
  1897.  
  1898.    NOTES
  1899.     If you pass 0 values for a division operation,
  1900.     the corresponding CTM entry will be set to 0.
  1901.  
  1902.    BUGS
  1903.  
  1904.    SEE ALSO
  1905.      MWLMeshTranslationChange(), MWLMeshTranslationGet()
  1906.     MWLMeshRotationChange(),MWLMeshRotationGet()
  1907.     MWLMeshCTMReset(),MWLMeshScaleGet()
  1908.  
  1909. meshwriter.library/MWLMeshScaleGet                                         meshwriter.library/MWLMeshScaleGet
  1910.  
  1911.    NAME    
  1912.      MWLMeshScaleGet -- Get the scale of the mesh its CTM.
  1913.  
  1914.    SYNOPSIS
  1915.     error = MWLMeshScaleGet( meshhandle,scale )
  1916.                              D1          A0
  1917.  
  1918.     ULONG MWLMeshScaleGet
  1919.          ( ULONG,TOCLVertex * );
  1920.  
  1921.    FUNCTION
  1922.     The scale of the CTM will be returned in the passed vertex structure.
  1923.  
  1924.    INPUTS
  1925.      meshhandle  - A valid handle of a mesh.
  1926.     scale       - Pointer to a vertex structure which will contain the scale factors.
  1927.  
  1928.    RESULT
  1929.      error - RCNOERROR          if all went well.
  1930.             RCNOMESH           if the handle is not valid.
  1931.  
  1932.    EXAMPLE
  1933.     error = MWLMeshScaleGet(meshhandle,&myscale);
  1934.  
  1935.    NOTES
  1936.  
  1937.    BUGS
  1938.  
  1939.    SEE ALSO
  1940.      MWLMeshTranslationChange(), MWLMeshTranslationChange()
  1941.     MWLMeshRotationChange(),MWLMeshRotationGet()
  1942.     MWLMeshScaleChange(),MWLMeshCTMReset()
  1943.  
  1944. meshwriter.library/MWLMeshTranslationChange                       meshwriter.library/MWLMeshTranslationChange
  1945.  
  1946.    NAME    
  1947.      MWLMeshTranslationChange -- Changes the translation of the CTM of the mesh.
  1948.  
  1949.    SYNOPSIS
  1950.     error = MWLMeshTranslationChange( meshhandle,translation,operation )
  1951.                                       D1          A0         D2
  1952.  
  1953.     ULONG MWLMeshTranslationChange
  1954.          ( ULONG,TOCLVertex *,ULONG );
  1955.  
  1956.    FUNCTION
  1957.     The translation of the CTM will be modified in function of the translation
  1958.     and the operation to perform.
  1959.  
  1960.    INPUTS
  1961.      meshhandle  - A valid handle of a mesh.
  1962.     translation - Pointer to a vertex structure which contains the coordinates
  1963.                   of the translation.
  1964.     operation   - A valid CTM operation.
  1965.                    CTMADD,CTMSUB,CTMMUL
  1966.                   CTMDIV,CTMSET,CTMRESET
  1967.  
  1968.    RESULT
  1969.      error - RCNOERROR          if all went well.
  1970.             RCNOMESH           if the handle is not valid.
  1971.             RCINVALIDOPERATION if the operation is not value.
  1972.  
  1973.    EXAMPLE
  1974.     error = MWLMeshTranslationChange(meshhandle,&mytranslation,myoperation);
  1975.  
  1976.    NOTES
  1977.     If you pass 0 values for a division operation,
  1978.     the corresponding CTM entry will be set to 0.
  1979.  
  1980.    BUGS
  1981.  
  1982.    SEE ALSO
  1983.      MWLMeshCTMReset(), MWLMeshTranslationGet()
  1984.     MWLMeshRotationChange(),MWLMeshRotationGet()
  1985.     MWLMeshScaleChange(),MWLMeshScaleGet()
  1986.  
  1987. meshwriter.library/MWLMeshTranslationGet                             meshwriter.library/MWLMeshTranslationGet
  1988.  
  1989.    NAME    
  1990.      MWLMeshTranslationGet -- Get the translation of the mesh its CTM.
  1991.  
  1992.    SYNOPSIS
  1993.     error = MWLMeshTranslationGet( meshhandle,translation )
  1994.                                    D1          A0
  1995.  
  1996.     ULONG MWLMeshTranslationGet
  1997.          ( ULONG,TOCLVertex * );
  1998.  
  1999.    FUNCTION
  2000.     The translation of the CTM will be returned in the passed vertex structure.
  2001.  
  2002.    INPUTS
  2003.      meshhandle  - A valid handle of a mesh.
  2004.     translation - Pointer to a vertex structure which will contain the translation.
  2005.  
  2006.    RESULT
  2007.      error - RCNOERROR          if all went well.
  2008.             RCNOMESH           if the handle is not valid.
  2009.  
  2010.    EXAMPLE
  2011.     error = MWLMeshTranslationGet(meshhandle,&mytranslation);
  2012.  
  2013.    NOTES
  2014.  
  2015.    BUGS
  2016.  
  2017.    SEE ALSO
  2018.      MWLMeshCTMReset(), MWLMeshTranslationChange()
  2019.     MWLMeshRotationChange(),MWLMeshRotationGet()
  2020.     MWLMeshScaleChange(),MWLMeshScaleGet()
  2021.  
  2022. meshwriter.library/MWLMeshTriangleAdd                                   meshwriter.library/MWLMeshTriangleAdd
  2023.  
  2024.    NAME    
  2025.      MWLMeshTriangleAdd -- Add a new triangle to the mesh according the CTM.
  2026.  
  2027.    SYNOPSIS
  2028.     error = MWLMeshTriangleAdd( meshhandle,materialhandle,vertex1,vertex2,vertex3 )
  2029.                                 D1         D2              A0       A1      A2
  2030.  
  2031.     ULONG MWLMeshTriangleAdd
  2032.          ( ULONG,ULONG,TOCLVertex *,TOCLVertex *,TOCLVertex * );
  2033.  
  2034.    FUNCTION
  2035.     A new triangle will be added to the mesh.
  2036.     This means a new polygon with 3 vertices.
  2037.     A copy of the contents passed by the vertex pointers will be made.
  2038.  
  2039.    INPUTS
  2040.      meshhandle     - A valid handle of a mesh.
  2041.     materialhandle - A valid handle of a material or 0 if you wont
  2042.                      assign a material to this polygon now.
  2043.     vertex1        - Pointer to the first vertex structure.
  2044.     vertex2        - Pointer to the second vertex structure.
  2045.     vertex3        - Pointer to the third vertex structure.
  2046.     
  2047.    RESULT
  2048.      error - RCNOERROR    if all went well.
  2049.             RCNOMESH     if the handle is not valid.
  2050.             RCNOMATERIAL if the handle is not valid.
  2051.             RCNOMEMORY   if there is not enough memory. 
  2052.  
  2053.    EXAMPLE
  2054.     error = MWLMeshTriangleAdd(meshhandle,materialhandle,&v1,&v2,&v3);
  2055.  
  2056.    NOTES
  2057.     Vertices have to be added in counterclock wise direction.
  2058.  
  2059.           v3
  2060.          / |
  2061.         /  |
  2062.        /   |
  2063.       /    |
  2064.      /     |
  2065.     v1--->v2
  2066.  
  2067.    BUGS
  2068.  
  2069.    SEE ALSO
  2070.      MWLMeshPolygonMaterialSet()
  2071.  
  2072. meshwriter.library/MWLMeshVertexAdd                                       meshwriter.library/MWLMeshVertexAdd
  2073.  
  2074.    NAME    
  2075.      MWLMeshVertexAdd -- Add a new vertex to the mesh its vertex list according the CTM.
  2076.  
  2077.    SYNOPSIS
  2078.     error = MWLMeshVertexAdd( meshhandle,vertex,index )
  2079.                               D1          A0    D2
  2080.  
  2081.     ULONG MWLMeshVertexAdd
  2082.          ( ULONG,TOCLVertex *,ULONG * );
  2083.  
  2084.    FUNCTION
  2085.     A new vertex will be added to the mesh its vertex list, without binding it to any
  2086.     polygon, which can be made later.
  2087.  
  2088.    INPUTS
  2089.      meshhandle   - A valid handle of a mesh.
  2090.     vertex       - Pointer to a vertex structure which contains the coordinates
  2091.                    of the new vertex.
  2092.     index        - Pointer to a variable which will contain the index of the vertex,
  2093.                    which will be needed for further use.
  2094.     
  2095.    RESULT
  2096.      error - RCNOERROR    if all went well.
  2097.             RCNOMESH     if the handle is not valid.
  2098.             RCNOMEMORY   if there is not enough memory. 
  2099.  
  2100.    EXAMPLE
  2101.     error = MWLMeshVertexAdd(meshhandle,&myvertex,&myindex);
  2102.  
  2103.    NOTES
  2104.     File formats which have an internal vertex list will get all vertices
  2105.     of the mesh, even if they were never used in a polygon.
  2106.  
  2107.    BUGS
  2108.  
  2109.    SEE ALSO
  2110.      MWLMeshPolygonVertexAssign()
  2111.  
  2112.